[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
VS_Append() Add a new record
Description:
VS_Append() adds a new record to the database associated with the
currently selected work area. If successfully added, each field in
the record is set to the empty value for its data type and the new
record becomes the current record.
Syntax:
l_Success = VS_Append()
Pass:
Nothing
Return:
l_Success is a logical expression that will be set to .T. if
VS_Append() was able to successfully add a new record to the database
otherwise l_Success will be set to .F.
Notes:
. Logical Records: VS_Append() does not respect logical
visibility. That is, if the record is successfully added, it becomes
the current record regardless of any index or filter condition.
. Network Environment: For a shared database on a network,
VS_Append() automatically places a record lock on the new record. If
the record cannot be loced, it is not added and VS_Append() will set
l_Success to .F.
Example:
BEGIN SEQUENCE
IF .NOT. CUST->( VS_Append() )
BREAK
ENDIF
...
END SEQUENCE
Usage:
VS_Append() will try to append a blank record to the currently
selected file. If it is unsuccessful, a non-screen destructive
message stating "Waiting for busy network. Press any key to abort."
will appear on the screen and VS_Append() will endlessly attempt to
append a blank record to the currently selected database. If the user
aborts the operation by pressing a key, VS_Append() will return a
logical value of false, it's your job as the programmer to abort the
operation and recover properly.
See Also:
VS_FakeLck
VS_RLock()
VS_FLock()
VS_Use()
VS_AddRec()
VS_DelRec()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson